UltraListViewItem Constructor(Object,Object[])

Creates a new instance of the UltraListViewItem class.

Syntax

Visual Basic

'Declaration
 
Public Function New( _
   ByVal itemValue As Object, _
   ByVal subItemValues() As Object _
)

C#

public UltraListViewItem( 
   object itemValue,
   object[] subItemValues
)

Parameters

itemValue

The initial value for the UltraListViewItem instance's Value property.

subItemValues

The initial values of the Value property for the UltraListViewSubItem instances which will be assigned to the UltraListViewItem instance's SubItems collection.

Remarks

An instance of the UltraListViewSubItem class is created for each of the members of the 'subItemValues' array that match a member of the control's SubItemColumns collection.

When using this constructor, the size of the subItemValues array must match the size of the UltraListView control's SubItemColumns collection. If the size of the subItemValues array does not match the size of the SubItemColumns collection, the values will be discarded when this UltraListViewItem is added to the control's Items collection. For example, if the subItemValues array contains three members, while the control's SubItemColumns collection contains only two, the last entry in the array will be discarded. For this reason it is best to fully populate the control's SubItemColumns collection before adding items created with this constructor.

This constructor is useful in cases where a large number of items are to be added to the the control's Items collection. Using the UltraListViewItemsCollection class' UltraListViewItemsCollection.Add method can be inefficient in these scenarios, since each time the method is called, a property change notification is issued. Typically, this constructor is used in conjunction with the UltraListViewItemsCollection class' UltraListViewItemsCollection.AddRange method, so that multiple items can be added, in an atomic operation, while triggering only one property change notification.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2